The Clerk for Microsoft Word: pilot installer for Mac
=====================================================

This adds The Clerk to Word on your Mac, for your own Mac account.
It needs no administrator password and no other software.

You need: Microsoft Word for Mac (Microsoft 365, or Office 2016 or later),
opened at least once, and the access code from your pilot invitation.

1. Unzip.
   Double-click The-Clerk-Pilot-Mac.zip (Safari may already have done
   this). A folder opens with this file, Install The Clerk.command,
   Remove The Clerk.command and manifest.hosted.xml. Keep them together.

2. Quit Word.
   In Word, choose Word, then Quit Word.

3. Open the installer, the first time with a right-click.
   The installer is not from the App Store, so macOS stops a plain
   double-click the first time. Instead:

   Right-click (or Control-click) Install The Clerk.command and choose
   Open. macOS asks: "macOS cannot verify the developer of
   "Install The Clerk.command". Are you sure you want to open it?"
   Click Open.

   On newer macOS (macOS 15 Sequoia and later) the message may instead be
   "Apple could not verify "Install The Clerk.command" is free of malware
   that may harm your Mac or compromise your privacy", with only Done and
   Move to Trash. Click Done. Then open System Settings, choose Privacy &
   Security, scroll down to Security, and click Open Anyway beside the
   line about Install The Clerk.command. Click Open Anyway again, and enter
   your Mac password if asked.

   A Terminal window opens and says what it is doing. If macOS asks
   whether "Terminal" may access data from other apps, click Allow: the
   installer puts The Clerk in Word's own folder. When it says Done, press
   any key, then close the window.

4. Open Word.
   Open a document. On the Home tab, click Add-ins, then choose
   The Clerk (hosted). The Clerk opens beside your document.

5. Enter your access code.
   Open The Clerk: it asks for your access code first. Enter the code from
   your pilot invitation and click Open The Clerk.

To remove The Clerk: quit Word, then open Remove The Clerk.command (the
first time with a right-click, as in step 3).

What the installer changes: it copies manifest.hosted.xml, named
"The Clerk (hosted).xml", into Word's add-ins folder:
~/Library/Containers/com.microsoft.Word/Data/Documents/wef
Word reads that folder when it starts. The Clerk itself runs from
https://empiricquest.com. Microsoft removes add-ins added this way by
clearing that folder, so Remove The Clerk.command clears it, and asks
first if it holds other add-ins.

Questions: info@empiricquest.com
